home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / comm1 / dannylg6.lha / Documentation.txt < prev    next >
Text File  |  1996-04-03  |  3KB  |  94 lines
  1.    Welcome to Dannylog. A logfile parser written especially for AWS, the
  2. Amiga Web Server.
  3.  
  4.    This software is freeware, though I would appreciate an email, postcard,
  5. or what-have-you. To get in contact with me;
  6.  
  7. Email: dannyman@uiuc.edu
  8. WWW: http://www.uiuc.edu/ph/www/djhoward
  9. Post: Daniel Howard
  10.      7310 N Claremont
  11.   Chicago, IL 60645-1808
  12.       United States
  13.  
  14. *** Disclaimer ***
  15.  
  16.    Dannylog is a work-in-progress. Additional information is available at
  17. http://arh0268.urh.uiuc.edu/~dannyman/dev/
  18.  
  19.    Dannylog is still in Alpha version. It should not crash your system,
  20. though if it does, I'd certainly like to hear about it! It is not very
  21. glamorous at this point and has far to go before it's much to look at. This
  22. documentation file was simply whipped-up one-the-fly, so it's probably not
  23. the most valuable resource either. If you would like to see more
  24. development, I'd appreciate words of encouragement, suggestions, etc. :)
  25.  
  26. *** Theory of Operation ***
  27.  
  28.    There are four executables at the moment.
  29.  
  30. Dannylog - Main program executable. Will read in from current directory
  31. stats/data.raw files, then it will parse an access log, and rewrite
  32. stats/data.raw files with data from the read logfile in them. After this,
  33. the access log can be deleted. As of version alpha5, Dannylog will not log
  34. any entry that returns a status other than 200, rather, it will print it to
  35. standard output, it is reccomended to pipe Dannylog's output to another file
  36. that server operator can peruse at leisure, fixing any problems that are
  37. revealed. The output is designed to be very easy-to-read.
  38.  
  39. t10 - Helper application that can analyse a stats/data.raw file
  40. and extract the top 10 or other values from them, matched against an AmigaDOS
  41. wildcard pattern.
  42.  
  43. *** Usage ***
  44.  
  45. --Dannylog--
  46.  
  47.    From a command-line, type;
  48.  
  49. Dannylog <logfile>
  50.  
  51.    whereas <logfile> is an access log generated by AWS.
  52.  
  53.    For example;
  54.  
  55. Dannylog aws:access.log
  56.  
  57. --t10--
  58.  
  59.    From a command-line, type;
  60.  
  61. t10 <statsfile> [Pattern] [NUM]
  62.  
  63.    Whereas <statsfile> is a file generated by Dannylog of the form
  64. stats/data.raw and [Pattern] is an optional AmigaDOS wildcard pattern that
  65. is matched case-insensitively against the data in question. The pattern
  66. defaults to #? if none is given, thus no matching is done and the absolute
  67. top ten of a given field are returned. NUM is another optional paramater if
  68. you want something other than the top ten returned. Another option switch
  69. has been added with alpha5. If HTML is specified on command-line, Dannylog
  70. will write output as an HTML table.
  71.  
  72.    Example;
  73.  
  74. t10 stats/hosts.raw num 5 pattern #?uiuc#?
  75.  
  76.    This will tell you the top five requesting hosts from the University of
  77. Illinois ...
  78.  
  79. --s/dostats--
  80.  
  81.    The file s/dostats is included with this archive. It is a script I use on
  82. my system as AWS:s/dostats to do stuff. Take a look at it to get a good idea
  83. of how things work. To see what it generates, refer to
  84. http://arh0268.urh.uiuc.edu/stats/access.html
  85.  
  86. *** Important Note ***
  87.  
  88.    t10 REQUIRES at least 8k of stack! If you do not set this, you risk
  89. crashing, BIG TIME! Dannyman reccomends saying "stack 10000" before running
  90. t10!
  91.  
  92.    Dannylog expects that in the directory from which you run it that there
  93. be a directory called stats this is where Dannylog sends most output.
  94.